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Foreword 



This Technical Specification has been produced by the 3"^ Generation Partnership Project (3GPP). 

3GPP acknowledges the contribution of the Parlay X Web Services specifications from The Parlay Group. The Parlay 
Group is pleased to see 3GPP acknowledge and publish the present document, and the Parlay Group looks forward to 
working with the 3GPP community to improve future versions of the present document. 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The present document is part 12 of a multi-part deliverable covering the 3' Generation Partnership Project; Technical 
Specification Group Core Network and Terminals; Open Service Access (OSA); Parlay X Web Services, as identified 
below: 



Part 1 


"Common"; 


Part 2 


"Third party call"; 


Part 3 


"Call Notification"; 


Part 4 


"Short Messaging"; 


Parts 


"Multimedia Messaging"; 


Part 6 


"Payment"; 


Part? 


"Account management"; 


Parts 


"Terminal Status"; 


Part 9 


"Terminal location"; 


Part 1 


3: "Call handling"; 


Parti 


1: "Audio call"; 


Part] 


2: "Multimedia conference"; 


Parti 


3: "Address Hst management"; 


Parti 


4: "Presence". 



£75/ 



3GPP TS 29.1 99-1 2 version 6.1 .0 Release 6 6 ETSI TS 1 29 1 99-1 2 V6.1 .0 (2005-06) 

1 Scope 

The present document is Part 12 of the Stage 3 Parlay X Web Services specification for Open Service Access (OS A). 

The OS A specifications define an architecture that enables application developers to make use of network functionality 
through an open standardized interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA are 
contained in 3GPP TS 23.127 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the Multimedia Conference Web Service aspects of the interface. All aspects of the 
Multimedia Conference Web Service are defined here, these being; 

Name spaces. 

Sequence diagrams. 

Data definitions. 

Interface specification plus detailed method descriptions. 

Fault definitions. 

Service policies. 

WSDL Description of the interfaces. 

The present document has been defined jointly between 3GPP TSG CT WG5, ETSI TISPAN and The Parlay Group. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TR 21.905: "Vocabulai-y for 3GPP Specifications". 

[2] 3GPP TS 22. 127: "Service Requirement for the Open Services Access (OSA); Stage 1 ". 

[3] 3GPP TS 23. 127; "Virtual Home Environment (VHE) / Open Service Access (OSA); Stage 2". 

[4] 3GPP TS 22.101; "Service aspects; Service principles". 

[5] W3C Recommendation (2 May 2001); "XML Schema Part 2; Datatypes". 

NOTE; Available at http;//www.w3.org/TR/2001/REC-xmlschema-2-20010502/ . 

[6] 3GPP TS 29.199-1; "Open Service Access (OSA); Parlay X Web Services; Part 1; Common". 

3 Definitions and abbreviations 
3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 29.199-1 [6] apply. 
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3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in 3GPP TS 29.199-1 [6] apply. 



Detailed service description 



The Multimedia Conferencing is a simple Web Service that allows the creation of a multimedia conference and the 
dynamic management of the participants and the media involved. 

The underlying model of the service is based on the following entities: 

• Conference: a "context" (uniquely identified) to which participants can be added/removed. 

• Participant: each of the parties involved in the conference. Media can be added/removed for each participant. 
There may exist a participant that is also the "owner" of the conference, i.e. the user who can end the call and/or 
be the reference user for billing purposes. 

• Media: the conference can utilize multiple media streams to support the participants' communication. In 
particular both audio and video streams are available, including the specific stream direction (i.e. in, out, 
bidirectional). 

An application setting up a multimedia conference must initially invoke the createConference method. The result of 
such invocation is the creation of a "context" that represents a "virtual" room where users can "meet". A unique 
identifier is assigned to the just-created conference. At this stage no participant is connected yet. 

Subsequently the application may wish to add participants to the conference. In order to do so the method 
inviteParticipant can be used. The result of such method is to alert the user of the incoming connection request 
(e.g. the user's terminal rings). 



If the application wishes to check whether the user has accepted the invitation (i.e. is connected) it can invoke (at a later 
time) the getParticipantlnfo method. 

Note that: 

• As soon as the first participant connects, the conference becomes "active". The duration of the conference is then 
measured starting from the moment the conference has became active. 

• The initial media set utilized by the participant will depend on the conference type and the media actually 
supported by the participant's terminal. 

During the conference session the application is able to: 

• Add (or remove) a specific media stream to a single participant: e.g. adding a video bidirectional stream to a 
participant that has an audio connection to the conference. This can be obtained by invoking the 
addMediaFor Participant and the DeleteMediaFor Participant methods. 

• Disconnect a participant from the conference, by invoking the disconnectParticipant method. 

• Retrieve information related to the conference and its status, by invoking getConferencelnfo and 
getParticipants. 

There are different conditions that can determine the end of the conference: 

1) The application may invoke the method endConference, that "forces" the termination of the conference and the 
disconnection of all participants. 

2) The owner of the conference (if defined) leaves the conference. If the owner is not defined this condition will 
apply when all the participants have left the conference (disconnected). 

3) The conference duration exceeds a maximum value (specified during the conference creation step). 
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5 Namespaces 

The Multimedia Conference interface uses the namespace: 

http://www.csapi.org/wsdl/parlayx/multimedia_conference/v2_l 
The data types are defined in the namespace: 

http://www.csapi.org/schema/parlayx/multimedia_conference/v2_l 

The 'xsd' namespace is used in the present document to refer to the XML Schema data types defined in 
XML Schema [5]. The use of the name 'xsd' is not semantically significant. 
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6 Sequence diagrams 



The following sequence diagrams illustrate typical scenarios of interaction between an application and the Multimedia 
Conferencing Web Service. 



6.1 Setting up a conference 

Set up a multimedia conference call. 
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6.2 Adding and Removing IVIedia 

On an existing conference call, add media to, or remove media from, a participant. 
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6.3 Conference owner disconnects 

During a conference call, the conference owner disconnects. 
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6.4 All participants disconnect 

End of conference call processing when all participants disconnect. 
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6.5 Conference ended by application 

End of conference call processing when the conference is ended by the application. 
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7 XML Schema data type definition 



7.1 ConferenceStatus enumeration 



Element name 

Initial 

Active 



Description 

Tine conference lias been created but no participant is connected yet 
Tiie conference is active, i.e. at least one user lias connected 



Terminated 



The conference was terminated 



7.2 



Conferencelnfo structure 



Name 


Type 


Optional 


Description 


Status 


ConferenceStatus 


No 


Status of the conference 


StartTime 


xsd:dateTime 


No 


The time at which the conference was created 


Duration 


xsd:int 


No 


The duration of the conference so far (in seconds) 


Owner 


xsd:anyURI 


No 


Conference owner 


NumberOfParticipants 


xsd:int 


No 


Current number of connected participants 


IVIaximumNumberOf Participants 


xsd:int 


No 


IVIaximum number of participants 


Conferenceldentifier 


xsd:string 


No 


Conference identifier 


ConferenceDescription 


xsd:string 


No 


Conference description 



7.3 Participantlnfo structure 



Name 


Type 


Optional 


Description 


Participant 


xsd:anyURI 


No 


Participant identifier 


CodecVideoln 


xsd:string 


No 


Codec Video IN 


CodecVideoOut 


xsd:string 


No 


Codec Video OUT 


CodecAudioln 


xsd:string 


No 


Codec Audio IN 


CodecAudioOut 


xsd:string 


No 


Codec Audio OUT 


StartTime 


xsd:dateTime 


No 


Time this participant joined the conference 


Status 


ParticipantStatus 


No 


Status of participant 



7.4 ParticipantStatus enumeration 



Element name 


Description 


Invited 


Participant invited but not connected yet 


Connected 


Participant connected 


Disconnected 


Participant disconnected 



7.5 



IVIedia enumeration 



Element name 


Description 


Audio 


Audio media type 


Video 


Video media type 


Chat 


Chat media type 


Data 


Other media type 



7.6 



IVIediaDirection enumeration 



Element name Description 

In Incoming 

Out Outgoing 



InOut 



Bidirectional 
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8 



Web Service interface definition 



8.1 



Interface: IVIultimediaConference 



The MultimediaConference interface can be used by an application for creating a multimedia conference call and for 
dynamically managing the participants and the media involved in the call. 



8.1 .1 Operation: createConference 



The invocation of createConference requests to create a multi-media conference with initially no participants 
connected. The reference to the new multimedia conference is returned in the output parameter. 

The conference termination can be driven either by a user action or by the expiring of a maximum duration. In 
particular, three possible situations are considered. In the first scenario, the concept of the "conference owner" is used. 
This user that has the control of the call and when the conference owner leaves the conference, all users are 
disconnected (such a user could be for instance the reference for the conference billing). In this scenario, the optional 
parameter conferenceOwner is present in the method call. 

In the second scenario, the conference is terminated when the last participant abandons (in this case the parameter 
conferenceOwner is not present). 

A third case is when the optional parameter maximumDuration is present: in this situation, when the maximum 
duration is reached, the conference is terminated. 

The selection of the scenario depends on the presence of the optional parameters; if no optional parameter is present, the 
conference end condition is the disconnection of the last user in conference, if both are present, the conference is 
terminated when the duration expires (this case could happen if the information concerning the conference owner is 
needed for billing purposes). 

The values maximumDuration and maximumNumberOfParticipants must not exceed the corresponding service 
policies otherwise a policy exception is raised. 



8.1.1.1 



Input message: createConferenceRequest 



Part name 


Part type 


Optional 


Description 


Conferencelype 


xsd:string 


Yes 


Conference type, i.e. one of a list of operator- 
specific identifiers that indicates how the 
conference is rendered on the terminals 


ConferenceDescription 


xsd:string 


No 


A text describing the conference 


Charging 


common:Cliarginglnformation 


Yes 


If present, defines the charge per unit of time 
consumed on the conference call. If the 
service does not support charging, a 
PolicyException (POL0008) will be returned. 


MaximumDuration 


xsd:int 


Yes 


If present it represents the maximum duration 
of the multimedia conference in seconds. If 
this parameter is present, it represents the 
end condition of the conference. 


IVIaximumNumberOf Participants 


xsd:int 


No 


Maximum number of participants allowed 


ConferenceOwner 


xsd:anyURI 


Yes 


It is the address of the multimedia conference 
owner. If this parameter is present, and the 
maximumDuration is not present, the 
conference is terminated when this user 
disconnects, else this information can be used 
for billing or other purpose 



8.1 .1 .2 Output message: createConferenceResponse 



Part name 

Conference Identifier 



Part type Optional 

xsd:string |No 



Description 

Conference identifier 
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8.1.1.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0002: Invalid input value. 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0008: Charging not supported. 

• POL0240: Too many participants. 

• POL0242: Maximum duration exceeded. 

8.1.2 Operation: getConferencelnfo 

The invocation of getConferencelnfo requests the information concerning the current status of the multi-media 
conference call identified by conferenceldentifier. 



8.1.2.1 



Input message: getConferencelnfoRequest 



Part name 


Part type 


Optional 


Description 


Conferenceldentifier 


xsd:string 


No 


Conference identifier 



8.1.2.2 



Output message: getConferencelnfoResponse 



Part name 

Conferencelnfo 



Part type 

Conferencelnfo 



Optional Description 

No Status of tlie conference 



8.1.2.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0002: Invalid input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

8.1.3 Operation: endConference 

The invocation of endConference requests to terminate the multi-media conference call identified by 
conferenceldentifier. 



8.1.3.1 



Input message: endConferenceRequest 



Part name 

Conferenceldentifier 



Part type Optional 

xsd:string |No 



Description 

Conference identifier 
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8.1.3.2 



Output message: endConferenceResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1.3.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

8.1.4 Operation: inviteParticipant 

The invocation of inviteParticipant requests to add a new participant specified by participant to the multi-media 
conference call identified by conferenceldentifier. The media used for the initial connection of the new participant 
depends on the conference type and the participant's supported media. 

The operation will fail if the conference has already reached the maximum number of participants (as specified in the 
creation operation). 



8.1.4.1 



Input message: InviteParticipantRequest 



Part name 


Part type 


Optional 


Description 


Conferenceldentifier 


xsd:string 


No 


Conference identifier 


Participant 


xsd:anyURI 


No 


New participant invited 



8.1.4.2 



Output message: InviteParticipantResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1 .4.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0240: Too many participants. 

8.1.5 Operation: disconnectParticipant 

The invocation of disconnectParticipant requests to disconnect the participant specified by participant from the 
multi-media conference call identified by conferenceldentifier. 
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8.1.5.1 



Input message: disconnectParticipantRequest 



Part name 


Part type 


Optional 


Description 


Conferenceldentifier 


xsd:string 


No 


Conference identifier 


Participant 


xsd:anyURI 


No 


Participant 



8.1.5.2 



Output message: disconnectParticipantResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1 .5.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

8.1.6 Operation: getParticipantlnfo 

The invocation of getParticipantlnfo requests information concerning the current status of the participant specified by 
participant, in the multi-media conference call identified by conferenceldentifier. 



8.1.6.1 



Input message: getParticipantlnfoRequest 



Part name 


Part type 


Optional 


Description 


Conferenceldentifier 


xsd:string 


No 


Conference identifier 


Participant 


xsd:anyURI 


No 


Participant 



8.1 .6.2 Output message: getParticipantlnfoResponse 



Part name 

Participantlnfo 



Part type 

Participantlnfo 



Optional 

No 



Description 

Status of the participant 



8.1.6.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0002: InvaUd input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

8.1.7 Operation: getParticipants 

The invocation of getParticipants requests information concerning the current status of each participant of the multi- 
media conference call identified by conferenceldentifier. The output includes participants already disconnected from 
the conference (if any). 
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8.1.7.1 



Input message: getParticipantsRequest 



Part name 


Part type 


Optional 


Description 


Conference Identifier 


xsd:string 


No 


Conference identifier 



8.1.7.2 



Output message: getParticipantsResponse 



Part name Part type 

Participants [Participantlnfo [0. .unbounded] 



Optional 

Yes 



Description 

Array containing status information for eacii participant 



8.1 .7.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

8.1.8 Operation: addMediaForParticipant 

The invocation of addMediaForParticipant requests to add a media stream to the media set used by participant. The 
operation is executed on a single participant connected to the multi-media conference call identified by 
conferenceldentifier. The new media has to be compatible with the type of multimedia conference and the set of media 
supported by the participant terminal, otherwise the operation will fail. 



8.1.8.1 



Input message: addMediaForParticipantRequest 



Part name 

Conferenceldentifier 



Part type Optional Description 

xsd:string |sio Conference identifier 



Participant 



xsd:anyURI No 



Participant 



IVIedia 

IVIediaDirection 



Media No^ 

MediaDirection No 



It identifies fine new media stream the participant will receive/send. 
In indicates the direction of the media stream to add (in, out, etc.) 



8.1.8.2 



Output message: addMediaForParticipantResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1.8.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: InvaUd input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0241: Unavailable media. 
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8.1 .9 Operation: deleteMediaForParticipant 

The invocation of deleteMediaForParticipant requests to remove a media stream from the media set used by 
participant. The operation is executed on a single participant connected to the multi-media conference call identified 
by conferenceldentifier. 



8.1.9.1 



Input message: deleteMediaForParticipantRequest 



Part name 


Part type 


Optional 


Description 


Conferenceldentifier 


xsd:string 


No 


Conference identifier 


Participant 


xsd:anyURI 


No 


Participant 


Media 


IVIedia 


No 


It identifies the media the user is not enabled to use any more. 


MediaDirection 


IVIediaDlrection 


No 


In indicates the direction of the media stream to remove (in, out, etc.) 



8.1.9.2 



Output message: deleteMediaForParticipantResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1.9.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0002: Invahd input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 



9 Fault definitions 

9.1 PolicyException 



9.1 .1 POL0240: Too many participants 

Too many participants. 



Name 

Message Id 



Description 

<POL0240> 



Text 
Variables 



Too many participants 
None 



9.1 .2 POL0241 : Unavailable media 



Name 


Description 


Message Id 


<POL0241> 


Text 


Unavailable media 


Variables 


None 
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9.1 .3 POL0242: Maximum duration exceeded 



Name 



Description 



Message Id 



:POL0242> 



Text 



Maximum duration exceeded. Maximum allowed Is %1 seconds. 



Variables 



%1 - maximum duration set by service policy 



10 Service policies 



Name 

MaximumDuration 
MaximumParticipants 



ChargingSupported 



Type 

xsd:int 
xsd:int 



xsd:boolean 



Description 

Maximum duration (in seconds) a conference may be set up for 
Maximum number of participants a conference may be set up for 



Is charging supported for the createConference operation 



£75/ 



3GPP TS 29.1 99-1 2 version 6.1 .0 Release 6 22 ETSI TS 1 29 1 99-1 2 V6.1 .0 (2005-06) 



Annex A (normative): 

WSDL for Multimedia conference 



The document/literal WSDL representation of this interface specification is compliant to 3GPP TS 29.199-1 [6] and is 
contained in text files (contained in archive 29199-12-610-doclit.zip) which accompanies the present document. 
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Annex B (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Old 


New 


Sep 2004 


CN 25 


NP-040360 


-- 


-- 


Draft v1 00 submitted to TSG CN#25 for Approval. 


1.0.0 


6.0.0 


Jun 2005 


CT 28 


CP-050221 


0001 


-- 


OptionalsforPart 12 


6.0.0 


6.1.0 
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Document history 


V6.0.0 
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V6.1.0 
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Publication 
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